Auto merge of #4453 - behnam:book, r=alexcrichton
authorbors <bors@rust-lang.org>
Thu, 31 Aug 2017 21:08:09 +0000 (21:08 +0000)
committerbors <bors@rust-lang.org>
Thu, 31 Aug 2017 21:08:09 +0000 (21:08 +0000)
commit97452de95b9c0f58fd8b679f594d8dacc7bec267
treea6876309c956f0a49f939f68ff5a3918c5f40e84
parentf519d3de318269754c331be006ce7dc0eaeb5004
parentbd5ecd43fcc1fad301bfdecfeac7284ad64b5d7a
Auto merge of #4453 - behnam:book, r=alexcrichton

Import mdBook-based docs and sync

Since we decided to keep the mdBook-based docs in-repo, I have imported the existing converted docs from <https://github.com/istankovic/cargo-book> under `/src/doc/book/` here, and have synced the current docs and the mdBook-based ones manually, file-by-file.

I have created a `MIGRATION_MAP` file, which shows the relationship between old docs and new ones. The first column is the old file, the second column is the canonical location in mdBook, and the rest of columns are globs of other files in mdBook containing content from the old file.

The first and second column of `MIGRATION_MAP` shall later be used to create redirect rules from `doc.crates.io/` to `doc.rust-lang.org/cargo/`.

I will also add a README file to remind everyone to keep these files in sync during the migration.

There are also two or three small wording fixes here, which I'll note inline.

This is a retry of <https://github.com/rust-lang/cargo/pull/4220>.

First step for <https://github.com/rust-lang/cargo/issues/4040>.